org.springframework.orm.jpa.vendor

Class HibernateJpaDialect

java.lang.Object

org.springframework.orm.jpa.DefaultJpaDialect

org.springframework.orm.jpa.vendor.HibernateJpaDialect

All Implemented Interfaces:

java.io.Serializable, PersistenceExceptionTranslator, JpaDialect

public class HibernateJpaDialect
extends DefaultJpaDialect

JpaDialect implementation for Hibernate EntityManager. Developed against Hibernate 3.6 and 4.2/4.3.

Since:

2.0

Author:

Juergen Hoeller, Costin Leau

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	HibernateJpaDialect.HibernateConnectionHandle
private static class	HibernateJpaDialect.SessionTransactionData

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.Class<?>	optimisticLockExceptionClass
private static java.lang.Class<?>	pessimisticLockExceptionClass
private boolean	prepareConnection

Constructor Summary

Constructors

Constructor and Description
HibernateJpaDialect()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	beginTransaction(EntityManager entityManager, TransactionDefinition definition) This implementation invokes the standard JPA Transaction.begin method.
void	cleanupTransaction(java.lang.Object transactionData) This implementation does nothing, since the default beginTransaction implementation does not require any cleanup.
protected DataAccessException	convertHibernateAccessException(HibernateException ex) Convert the given HibernateException to an appropriate exception from the org.springframework.dao hierarchy.
protected java.lang.Object	doPrepareTransaction(Session session, boolean readOnly, java.lang.Integer previousIsolationLevel)
ConnectionHandle	getJdbcConnection(EntityManager entityManager, boolean readOnly) This implementation always returns null, indicating that no JDBC Connection can be provided.
protected Session	getSession(EntityManager em)
java.lang.Object	prepareTransaction(EntityManager entityManager, boolean readOnly, java.lang.String name) Prepare a JPA transaction, applying the specified semantics.
void	setPrepareConnection(boolean prepareConnection) Set whether to prepare the underlying JDBC Connection of a transactional Hibernate Session, that is, whether to apply a transaction-specific isolation level and/or the transaction's read-only flag to the underlying JDBC Connection.
DataAccessException	translateExceptionIfPossible(java.lang.RuntimeException ex) This implementation delegates to EntityManagerFactoryUtils.

Methods inherited from class org.springframework.orm.jpa.DefaultJpaDialect

releaseJdbcConnection

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

optimisticLockExceptionClass

private static java.lang.Class<?> optimisticLockExceptionClass

pessimisticLockExceptionClass

private static java.lang.Class<?> pessimisticLockExceptionClass

prepareConnection

private boolean prepareConnection

Constructor Detail

HibernateJpaDialect

public HibernateJpaDialect()

Method Detail

setPrepareConnection

public void setPrepareConnection(boolean prepareConnection)

Set whether to prepare the underlying JDBC Connection of a transactional Hibernate Session, that is, whether to apply a transaction-specific isolation level and/or the transaction's read-only flag to the underlying JDBC Connection.

Default is "true" on Hibernate EntityManager 4.x (with its 'on-close' connection release mode, and "false" on Hibernate EntityManager 3.6 (due to the 'after-transaction' release mode there). Note that Hibernate 4.2+ is strongly recommended in order to make isolation levels work efficiently.

If you turn this flag off, JPA transaction management will not support per-transaction isolation levels anymore. It will not call Connection.setReadOnly(true) for read-only transactions anymore either. If this flag is turned off, no cleanup of a JDBC Connection is required after a transaction, since no Connection settings will get modified.

See Also:

Connection.setTransactionIsolation(int), Connection.setReadOnly(boolean)

beginTransaction

public java.lang.Object beginTransaction(EntityManager entityManager,
                                         TransactionDefinition definition)
                                  throws PersistenceException,
                                         java.sql.SQLException,
                                         TransactionException

Description copied from class: DefaultJpaDialect

This implementation invokes the standard JPA Transaction.begin method. Throws an InvalidIsolationLevelException if a non-default isolation level is set.

This implementation does not return any transaction data Object, since there is no state to be kept for a standard JPA transaction. Hence, subclasses do not have to care about the return value (null) of this implementation and are free to return their own transaction data Object.

Specified by:

beginTransaction in interface JpaDialect

Overrides:

beginTransaction in class DefaultJpaDialect

Parameters:

entityManager - the EntityManager to begin a JPA transaction on

definition - the Spring transaction definition that defines semantics

Returns:

an arbitrary object that holds transaction data, if any (to be passed into JpaDialect.cleanupTransaction(java.lang.Object)). May implement the SavepointManager interface.

Throws:

java.sql.SQLException - if thrown by JDBC methods

TransactionException - in case of invalid arguments

PersistenceException

See Also:

javax.persistence.EntityTransaction#begin, InvalidIsolationLevelException, DefaultJpaDialect.cleanupTransaction(java.lang.Object)

prepareTransaction

public java.lang.Object prepareTransaction(EntityManager entityManager,
                                           boolean readOnly,
                                           java.lang.String name)
                                    throws PersistenceException

Description copied from interface: JpaDialect

Prepare a JPA transaction, applying the specified semantics. Called by EntityManagerFactoryUtils when enlisting an EntityManager in a JTA transaction or a locally joined transaction (e.g. after upgrading an unsynchronized EntityManager to a synchronized one).

An implementation can apply the read-only flag as flush mode. In that case, a transaction data object can be returned that holds the previous flush mode (and possibly other data), to be reset in cleanupTransaction.

Implementations can also use the Spring transaction name to optimize for specific data access use cases (effectively using the current transaction name as use case identifier).

Specified by:

prepareTransaction in interface JpaDialect

Overrides:

prepareTransaction in class DefaultJpaDialect

Parameters:

entityManager - the EntityManager to begin a JPA transaction on

readOnly - whether the transaction is supposed to be read-only

name - the name of the transaction (if any)

Returns:

an arbitrary object that holds transaction data, if any (to be passed into cleanupTransaction)

Throws:

PersistenceException

See Also:

JpaDialect.cleanupTransaction(java.lang.Object)

doPrepareTransaction

protected java.lang.Object doPrepareTransaction(Session session,
                                                boolean readOnly,
                                                java.lang.Integer previousIsolationLevel)
                                         throws PersistenceException

Throws:

PersistenceException

cleanupTransaction

public void cleanupTransaction(java.lang.Object transactionData)

Description copied from class: DefaultJpaDialect

This implementation does nothing, since the default beginTransaction implementation does not require any cleanup.

Specified by:

cleanupTransaction in interface JpaDialect

Overrides:

cleanupTransaction in class DefaultJpaDialect

Parameters:

transactionData - arbitrary object that holds transaction data, if any (as returned by beginTransaction or prepareTransaction)

See Also:

DefaultJpaDialect.beginTransaction(EntityManager, org.springframework.transaction.TransactionDefinition)

getJdbcConnection

public ConnectionHandle getJdbcConnection(EntityManager entityManager,
                                          boolean readOnly)
                                   throws PersistenceException,
                                          java.sql.SQLException

Description copied from class: DefaultJpaDialect

This implementation always returns null, indicating that no JDBC Connection can be provided.

Specified by:

getJdbcConnection in interface JpaDialect

Overrides:

getJdbcConnection in class DefaultJpaDialect

Parameters:

entityManager - the current JPA EntityManager

readOnly - whether the Connection is only needed for read-only purposes

Returns:

a handle for the JDBC Connection, to be passed into releaseJdbcConnection, or null if no JDBC Connection can be retrieved

Throws:

java.sql.SQLException - if thrown by JDBC methods

PersistenceException

See Also:

JpaDialect.releaseJdbcConnection(org.springframework.jdbc.datasource.ConnectionHandle, EntityManager), ConnectionHandle.getConnection(), SimpleConnectionHandle, JpaTransactionManager.setDataSource(javax.sql.DataSource), NativeJdbcExtractor

translateExceptionIfPossible

public DataAccessException translateExceptionIfPossible(java.lang.RuntimeException ex)

Description copied from class: DefaultJpaDialect

This implementation delegates to EntityManagerFactoryUtils.

Specified by:

translateExceptionIfPossible in interface PersistenceExceptionTranslator

Overrides:

translateExceptionIfPossible in class DefaultJpaDialect

Parameters:

ex - a RuntimeException to translate

Returns:

the corresponding DataAccessException (or null if the exception could not be translated, as in this case it may result from user code rather than from an actual persistence problem)

See Also:

EntityManagerFactoryUtils.convertJpaAccessExceptionIfPossible(java.lang.RuntimeException)

convertHibernateAccessException

protected DataAccessException convertHibernateAccessException(HibernateException ex)

Convert the given HibernateException to an appropriate exception from the org.springframework.dao hierarchy.

Parameters:

ex - HibernateException that occurred

Returns:

the corresponding DataAccessException instance

getSession

protected Session getSession(EntityManager em)